home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / sticpsrc.lzh / DOC / NRMAN.ARC / NRMAN.TXT
Text File  |  1989-01-09  |  18KB  |  424 lines
  1.  
  2.  
  3.                 NET/ROM support in the KA9Q NET Package
  4.  
  5.                             Dan Frank, W9NK
  6.  
  7. INTRODUCTION
  8.  
  9.    The NET/ROM support for the KA9Q package serves three purposes:
  10.  
  11.     1) Existing NET/ROM networks may be used to send IP traffic.
  12.  
  13.     2) NET may be used as a NET/ROM packet switch.
  14.  
  15.     3) NET may be used to communicate with NET/ROM nodes, and its
  16.        mailbox facility can accept connects over the NET/ROM network.
  17.  
  18.  
  19. SETTING UP THE NET/ROM INTERFACE
  20.  
  21.    No physical interface is completely dedicated to net/rom, which is as
  22. it should be.  You attach all your AX.25 interfaces, of whatever sort.
  23. Then you attach the net/rom pseudo-interface ("attach netrom").  Then
  24. you identify to the net/rom software those interfaces you want to allow
  25. it to use, with the "netrom interface" command.  The format of this
  26. command is:
  27.  
  28.     netrom interface ax0 #ipnode 192
  29.  
  30. The first argument is the name of the previously attached interface you
  31. want to use.  The second argument is the alias of your node, to be used in
  32. your routing broadcasts.  The alias is never used for anything else (as
  33. you will see!).  The last number is the net/rom quality figure.  This is
  34. used in computing the route qualities; it represents the contribution of
  35. this interface to the overall computation.  For a 1200 baud half-duplex
  36. connection, 192 is the right number.  
  37.  
  38.    You need a netrom interface command for every interface you're going
  39. to use with net/rom.
  40.  
  41.  
  42. TRACING ON THE NET/ROM INTERFACE
  43.  
  44.    If you want to trace your NET/ROM datagrams, don't try turning
  45. on trace mode for the "netrom" interface.  Nothing will break, but
  46. nothing will happen.  You should trace the individual AX.25 interfaces
  47. instead.
  48.  
  49.  
  50. ROUTING BROADCASTS
  51.  
  52.    Once you have set up your interfaces, you need to set some timers.
  53. There are two:  the nodes broadcast interval timer, and the obsolescence
  54. timer.  These are set in seconds, like the smtp timer.  You should usually
  55. set them to an hour.  You can set them to something different, if you want.
  56. If your local net/rom nodes broadcast every hour, but you want to do so
  57. every ten minutes, you can say:
  58.  
  59.     netrom nodetimer 600
  60.     netrom obsotimer 3600
  61.  
  62. Every time the obsotimer kicks, the obsolescence counts for all non-permanent
  63. entries are decremented by one.  When the count for an entry falls below
  64. five, it is no longer broadcast.  When it falls to 0, it is removed.  The
  65. count is initialized at 6.  These will eventually be settable parameters;
  66. you can adjust them now by changing the initializers for the variables
  67. in the source file.
  68.  
  69.    When you first come on the air, you can send out nodes broadcasts to
  70. tell the local nodes that you are available.  Use the command:
  71.  
  72.     netrom bcnodes ax0
  73.  
  74. where ax0 is the interface on which you want to send the broadcast.  Do
  75. this for every interface on which you want to do this.
  76.  
  77.    By default, the NET/ROM code does not broadcast the contents of your
  78. routing table.  This is as it should be, since usually we just want to
  79. be the endpoints of communications rather than relaying NET/ROM traffic.
  80. If you want to be a switch station, include the command:
  81.  
  82.     netrom verbose yes
  83.  
  84. in your autoexec.
  85.  
  86.    Sometimes you can hear broadcasts from nodes that can't hear you.  If
  87. your routing table gets filled with these unusable routes, your node will
  88. grind to a halt.  The solution to this is node broadcast filtering, via
  89. the netrom nodefilter command.  There is a filter list, which contains
  90. a list of callsigns and interfaces.  Then there is a filter mode, which
  91. indicates what to do with the list.
  92.  
  93.    If the filter mode is "none", no filtering is done.  If it is "accept",
  94. then only broadcasts from the indicated stations on the indicated 
  95. interfaces are accepted.  If it is "reject", then all broadcasts 
  96. except those from the listed stations on the listed interfaces are
  97. accepted.
  98.  
  99.    Because the net/rom code cannot at this time recognize unusable
  100. routes and try alternates, I strongly recommend use of the filter
  101. command to restrict broadcast acceptance to those nodes which you
  102. know you can reach.
  103.  
  104.  
  105. THE NET/ROM ROUTING TABLE
  106.  
  107.    The next net/rom commands are those used for maintaining
  108. the routing table.  They fall under the "netrom route" subcommand.
  109. "netrom add" adds a permanent entry to the routing table.  Its format
  110. is:
  111.  
  112.     netrom route add #foo w9foo ax0 192 w9rly
  113.  
  114. This command adds an entry for w9foo, whose alias is #foo, route
  115. quality 192, via w9rly on interface ax0.  Let's talk about what this
  116. means.  w9foo is the *destination* node, the one to whom you want 
  117. the packets routed by the net/rom network.  w9rly is your *neighbor*,
  118. the net/rom node to which you pass the packet to be forwarded.  Since
  119. w9rly may appear on more than one interface (the callsign may be used
  120. by more than one net/rom node on different bands), we specify that 
  121. we are to use ax0 to send the packet.
  122.  
  123.    With net/rom, like IP, we don't know exactly what route a packet
  124. will take to its destination.  We only know the name of a neighbor
  125. which has indicated a willingness to forward that packet (of course,
  126. the neighbor may be the destination itself, but that's unlikely in
  127. our application).  Net/rom sends the packet to the neighbor, with a
  128. network header specifying our callsign and that of the ultimate
  129. destination (in this case w9foo).
  130.  
  131.    We can use the netrom route add command to establish a digipeater
  132. path to the neighbor.  For example:
  133.  
  134.     netrom route add #foo w9foo ax0 192 w9rly wd9igi
  135.  
  136. This will cause us to use wd9igi as a digipeater in establishing our
  137. connection to the net/rom node w9rly.
  138.  
  139.    To drop the route to w9foo, you would type
  140.  
  141.     netrom route drop w9foo w9rly ax0
  142.  
  143.    To see the contents of your routing table, you may type
  144.  
  145.     netrom route
  146.  
  147. and to see the routing entries for an individual station you can type
  148.  
  149.     netrom route info <callsign>
  150.  
  151. You may not use an alias as an argument to the netrom route info command.
  152.  
  153.    I can not stress enough that "route add" and "netrom route add" are two
  154. different commands, with different purposes.  In general, you only need a
  155. "netrom route add" if you need to add a route to a net/rom node via a
  156. digipeater path.  If you find yourself using this command, ask yourself,
  157. "Why am I doing this?"  Many people do not understand that net/rom does
  158. automatic routing (well, sort of :-)).
  159.  
  160.  
  161. THE IMPORTANCE OF THE ROUTING TABLE
  162.  
  163.    The NET/ROM routing table is analogous to the IP routing table:  if
  164. there is nothing in it, your NET/ROM traffic will not go out.  You must
  165. either manually enter a list of routes (perhaps via your autoexec.net)
  166. or wait to receive routing broadcasts from your neighbors before your
  167. NET/ROM traffic will leave your station.
  168.  
  169.    If you go to send packets via NET/ROM and nothing happens, even if
  170. you have trace mode on, make sure that the destination node is in your
  171. NET/ROM routing table.  If sending IP traffic, double check the ARP table
  172. for an appropriate NET/ROM ARP entry for the destination node (see below
  173. for more information on the use of the ARP table).  The ARP table is not
  174. used for NET/ROM transport routing.
  175.  
  176.  
  177. INTERFACING WITH NET/ROMS USING YOUR SERIAL PORT
  178.  
  179.    What if you have a net/rom node or nodes, and you'd like to attach
  180. them to your computer via their serial interfaces, and use net as a
  181. packet switch?  It's very easy:  you have to attach those interfaces,
  182. using the "attach asy" command, but specifying type "nrs" instead of
  183. "slip" or "kiss".  "nrs" is the net/rom serial framing protocol, which
  184. is like KISS, but uses different framing characters and has an 8-bit
  185. checksum.
  186.  
  187.    When you attach an nrs interface, it can be used for passing IP
  188. datagrams or AX.25 frames over serial lines or modems.  To use it
  189. for net/rom, you have to identify it to the netrom code just like
  190. any other interface, with the "netrom interface" command.
  191.  
  192.  
  193. THE TIME TO LIVE INITIALIZER
  194.  
  195.    The "netrom ttl" command allows setting of the time-to-live
  196. initializer for NET/ROM datagrams.  I recommend a value of 16
  197. for most networks.  Use more if you expect to go more than 16 hops.
  198. The default is 64.
  199.  
  200.